home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / xpmconv.lzh / README.TXT < prev    next >
Text File  |  1994-01-31  |  3KB  |  84 lines
  1.  
  2.                                XPM Converter
  3.                                Version 1.00
  4.  
  5.                                by Steven Lee
  6.                              January 22, 1994
  7.  
  8.  
  9. Introduction
  10. ------------
  11. XPM Converter is a utility to convert X PixMap format to NEOchrome and
  12. vice versa.  In the future, it may support other popular Atari picture
  13. formats.  This program is freeware.
  14.  
  15. The archive file should contain the following files:
  16.  
  17.     XPMCONV.TTP - XPM Converter program
  18.     *.XPM       - Some XPM images
  19.     README.TXT  - This file
  20.  
  21.  
  22. Usage
  23. -----
  24. XPM Converter can run from the GEM desktop or from a command line
  25. interface (CLI) like COMMAND.TOS or a shell like Gulam.  From a CLI
  26. or shell, you simply issue:
  27.  
  28.     xpmconv <*.XPM> -o <*.NEO>
  29.  
  30. or
  31.  
  32.     xpmconv <-w width> <-h height> <*.NEO> -o <*.XPM>
  33.  
  34.        where *.NEO = NEOchrome file
  35.              *.XPM = XPM2 file
  36.  
  37.  
  38. From the desktop, double click on XPMCONV.TTP and provide the same
  39. input as above but leave out "xpmconv".
  40.  
  41.  
  42. What is XPM?
  43. ------------
  44. The X PixMap Format (XPM) was created by Arnaud Le Hors of GROUPE BULL.
  45. It is an ASCII representation of an image used by X Windows applications.
  46. The format is different from bitmaps in that it supports color.
  47.  
  48. The XPM library and documentation is available via ftp on
  49. avahi.inria.fr (138.96.24.30).
  50.  
  51. XPM Converter only supports the XPM2 format.  Sun provides an icon editor
  52. which can create XPM2 files.
  53.  
  54.  
  55. Limitations of XPM Converter
  56. ----------------------------
  57. The following are limitations of XPM Converter.
  58.  
  59.   1. Supports XPM2 format only.
  60.   2. Maximum number of colors is 16.
  61.   3. Only supports color specification using a "#" followed by the RGB
  62.      code in hexadecimal.  It will only use the first RGB code on the line.
  63.      The remaining data are ignored.
  64.   4. Maximum width is 320.  Maximum height is 200.
  65.   5. Maximum number of characters per pixel is 2.
  66.   6. No support for hotspot in XPM2 file.
  67.   7. No support for XPM2 extension (XPMEXT).
  68.  
  69.  
  70. Limitations on the Atari platform
  71. ---------------------------------
  72. Converting from an XPM2 file to NEOchrome results in loss or change of
  73. some information.  Most noticeably, the color values will be changed.
  74. Therefore, if you convert the picture back, it may not be the same as
  75. the original.
  76.  
  77.  
  78. Final comments
  79. --------------
  80. I created this program because I wanted to use my Atari at home to
  81. draw pixmaps and later transfer it over to my Sun workstation at work.
  82.  
  83. Send comments, questions, suggestions, bug reports to stevenl@robadome.com.
  84.